home *** CD-ROM | disk | FTP | other *** search
- The CDFlist program allows you to selectively list all (or a subset
- of) the variable data values from a CDF. The values can be displayed at the
- screen, output to a text file, or used to create a new CDF (the new CDF may
- be a subset of the original CDF).
-
- The user interface to CDFlist is contained on a
- single screen which is divided into several fixed windows and
- pop-up windows. The Action Menu controls the execution of
- the program. This menu allows you to move to a different
- window, start the data output, browse a help file, or
- exit the program. You must return to this menu each
- time you want to select a new variable, output option,
- listing type, or input CDF. This menu may be displayed
- at any time by entering Ctrl-F. Use the up and down
- arrow keys to highlight a choice in the Action Menu and
- then enter a carriage return to execute that function.
- Two very important windows are the Keypad Definition
- and Message windows. They contain information on keypad
- functionality and program status/error messages.
-
- When CDFlist is executed (and a CDF and/or directory is not
- entered on the command line), you must first specify the
- CDF you wish to list. If you enter
- a full disk/directory specification (without a CDF
- name), all of the CDFs in the specified directory will
- appear in a separate pop-up window. Use the up and down
- arrow keys to choose a CDF and then enter a carriage return
- to list that CDF.
-
- The Output window will then be
- displayed with the valid choices. Use the up and down
- arrow keys to scroll up and down within the menu and then
- enter a carriage return to select the desired output option.
- If output to an ASCII file or CDF is selected, you will be
- prompted for a file/CDF name. You may enter any
- file/CDF name valid for the operating system begin used
- or accept the default file/CDF name that appears. Do not enter a
- file extension (it is automatically appended). The file
- extension for a generated text file is .dat.
-
- The second window that remains constant on the screen is
- the Variable Selection window. This window allows the
- user to select the variables that are
- to be listed or put into a CDF along with any desired filters
- on the variables. You will automatically be
- placed in this window after you have entered an output
- option. You can also enter this window by entering Ctrl-F
- to bring up the Action Menu and then select
- the Select Variables menu option.
-
- There are three
- fields on each line in the Variable Selection window: variable
- name, minimum filter value, and maximum filter value.
- You can move forward to the next field by entering a carriage
- return or backwards to the previous field with a Ctrl-H. You may
- also use the up and down arrow keys to move vertically
- through the fields. When the cursor is positioned in
- a variable name field, entering Ctrl-P will
- display the variables in the CDF in a pop-up
- window. Use the arrow keys to highlight a variable
- and then enter a carriage return to select it. You can quit the
- pop-up window without selecting a variable by
- entering q (quit). You may also use the u and d keys to
- page up and down in the pop-up window. The first line
- in this pop-up menu contains **SELECT ALL**.
- Selecting this item causes all of the
- variables in the CDF to be selected.
-
- After selecting a variable, the
- cursor is positioned in the minimum filter field. A
- filter is simply the range of data that you would like to
- see from the selected variable. If just specifying a
- minimum filter value is sufficient, a maximum filter value need not be
- entered. You do not have to enter a filter for each
- selected variable. For a line of output (or a set of CDF variable
- values) to be written for a given record/indices, each filter must
- be passed. There are two ways to enter
- minimum and maximum filters. The first is by simply
- entering the desired values in the appropriate fields. The
- second method can only be used for variables that
- consist of a discrete set of values.
- This method involves entering a Ctrl-P (when in the
- desired filter field) which displays a
- pop-up window that contains the discrete values for the variable.
- The desired filter value may then be selected.
-
- When all of the desired variables and
- filters have been selected, enter Ctrl-F to display
- the Action Menu. Selecting Generate Output will cause
- the listing or new CDF to be generated. When CDFlist completes
- the generation of the output, the Action Menu is redisplayed.
- It may then be used to select a new CDF to list, respecify the output
- option, select new variables/filters, get online help, or exit the
- program.
-
- NOTE:
-
- If you are running CDFlist under UNIX, your terminal
- output will be limited to 132 chars per line. If too many variables
- have been selected, the output to a terminal screen will be truncated.
- Output to a file or CDF, however, will not be affected (as many variables
- as desired may be selected).
-